home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / gene / insr14d.zip / README.TXT < prev    next >
Text File  |  1994-05-21  |  10KB  |  236 lines
  1. Howdy, Cousin!                                     April 27, 1993
  2.  
  3. In about a half hour I'll be ready to upload InstaRel version 1.0
  4. to Compuserve and some other bulletin boards for the first time.
  5. This is kind of exciting, 'cause I've been working on this program
  6. (off and on) since about 1984, not long after the GEDCOM standard
  7. was established.  (I'm probably off on the 1984 date a little).
  8. Welcome to InstaRel!  To get more documentation after reading
  9. this, run InstaRel and then press the F1 key.
  10.  
  11. Version 1.04 Notes 5/21/94
  12.  
  13. Linked in a better new.obj, increased the stack size.
  14.  
  15. Version 1.03a Notes   8/31/93
  16.  
  17. Don't use the "Change Directory" feature. If you use the "Change
  18. Directory" feature then the program cannot find the files it needs
  19. to run.
  20.  
  21. After you load a GEDCOM file, you can exit the program without
  22. having to reload it.  The screen will not show the file name
  23. anymore, but it is still there and is available to perform the
  24. match.
  25.  
  26. You will see a status box while you are waiting for your GEDCOM file
  27. to load into the databasee.  The status box shows the percentage
  28. completed.  Sometimes the program seems to hang and the percentage
  29. completed does not increase for a while.  This happens with large
  30. GEDCOM files.  When the program runs out of memory, it copies the
  31. memory to disk.  The program seems to "hang" while this is
  32. happening.  The program will resume after a while, and will go
  33. slower because it is running from the disk instead of memory.  It
  34. is a good idea to use a disk cache program, such as smartdrv.exe,
  35. which will allow you to take advantage of extended memory.
  36.  
  37. Version 1.03 changes:  6/30/93
  38.  
  39. There was a potential memory problem upon exiting the program.
  40. This was never reported, but it was fixed.
  41.  
  42. Version 1.02 changes:  6/11/93
  43.  
  44. Fixed a speed problem.  There is a file included with InstaRel
  45. that determines what records are inserted into the database.
  46. This file is called HR.GRM.  It may be OK not to read in so
  47. much information for each individual.  So to speed up the
  48. program, I made some changes to HR.GRM.  If you want to use
  49. InstaRel to load in all the fields that it is capable of,
  50. copy HR.SLO to HR.GRM.
  51.  
  52. Fixed a memory problem.  InstaRel was trying to read in all the
  53. CONT tags that were children of SOUR tags.  If a GEDCOM file had
  54. a lot of these in one record, there was not enough memory to read
  55. it in.
  56.  
  57. Version 1.01 changes:   4/30/93
  58.  
  59. Fixed a bug that made large databases crash.
  60.  
  61. Fixed up the rule file.  I'm still working on the threshhold value
  62. and scores that are assigned if there is a match.
  63.  
  64. Added a better status screen while the database is being updated.
  65.  
  66. Version 1.00:
  67.  
  68.  
  69. THANKS
  70. A special THANKS goes to Michael Wise (who designed the first
  71. Personal Computer) who wrote the Daitch-Mokotoff Soundex algorithm
  72. for me.  He also helped with the code that processes the rules
  73. file.
  74.  
  75. HOW IT WORKS
  76.  
  77. About a year ago I developed a the prototype to InstaRel. The
  78. minute I finished writing the program I used it on two people that
  79. I had been working with at the Family History Department.  They
  80. both became my instant relatives!  I also extended my lines
  81. back further.
  82.  
  83. The program works by taking two or more GEDCOM files (your
  84. genealogy program should be able to make you a GEDCOM file) and
  85. comparing them. It is very sophisticated.  It looks to see if given
  86. names of children are the same as the parents or grandparents.  It
  87. compares dates of birth or christening dates.  It looks at marriage
  88. dates.    You can change the program so that it will report "maybe"
  89. matches or "for-sure" matches. I could go on, but you get the
  90. picture.
  91.  
  92. THE MATCH REPORT
  93.  
  94. Following is a sample match report:
  95.  
  96.                           HOW ARE WE RELATED?
  97.                                Created By
  98.                           INSTANT RELATIVES (r)
  99.                                22 MAY 1993
  100.  
  101.            |   GIVEN|            |               |               ─┐This
  102.     SURNAME|    NAME|  BIRTH DATE|    BIRTH PLACE|  DEATH DATE    ├─┐ top line
  103. -----------------------------------------------------------------─┘-│-----
  104. MOTHER'S| MOMS'S MOM                                                │
  105.  SURNAME|    SURNAME|SPOUSE SURNAME|  SP GVN| RFN NO|SUBMITTER      │
  106. --------------------------------------------------------------------│-----
  107.                *************** (Score: 52) ***************          │
  108.       Nurse|   Sarah| 14 NOV 1722| Salem,Essex,MA|     ─────────────┤ Describes
  109.         |           |        Putnam|  Samuel|  I2195|       29      │ the top
  110.                                                                     │ lines in
  111.                                                                     │ these 2
  112.       Nurse|   Sarah| 14 NOV 1722|               |     ─────────────┘ matches
  113. Mitchell|           |        Putnam|  Samuel|   R968|       45
  114.  
  115.                *************** (Score: 56) ***************
  116.   DAVENPORT|  Thomas|        1682|Cold Springs,We| 30 DEC 1759
  117. HITCHCOC|           |       LEGGETT|   Sarah|  I1200|        2
  118.  
  119.  
  120.   Davenport|  Thomas|        1682|               | 30 DEC 1759
  121.         |           |       Leggett|   Sarah|   I292|       31
  122.                *************** (Score: 74) ***************
  123.      HORTON|    John|  6 JUN 1672|Milton,Norfolk,| 15 OCT 1742
  124.         |           |       GARNSEY|Mehitabl|  I1354|        2  ──┐
  125.                                                                   │
  126.                This submitter number matches record in SUBMIT file│
  127. 0 @S2@ SUBM  ─────────────────────────────────────────────────────┘
  128. 1 NAME Larry Allen Maddocks
  129. 1 ADDR 935 Best Ave.
  130. 2 CONT Salt Lake City, Utah 84106
  131. 1 PHON 801 484 6958
  132. 1 COMM To be used with howrel.exe
  133.  
  134.                  Score, Threshhold, and the Rules File
  135.  
  136. Following are a few lines taken from the Rules file:
  137.  
  138. 5: A.surname B.surname s=
  139. /The following is the threshold for changing match sensitivity
  140. threshhold 50
  141. /end
  142.  
  143. The first line tells Instant Relatives to add 5 to the total score
  144. if the soundex
  145. of database A (Your database) and database B match.  Line two is a
  146. comment. Put
  147. a "/" in front of a line to designate comments.  Line three tells
  148. instant
  149. relatives to not declare a match until the total score is at least
  150. 50.  You can
  151. change this to a lower amount to get matches that are more "iffy."
  152. The "s=" in
  153. line one means to perform a soundex match.  Leaving the "s" off
  154. means perform an
  155. exact match.  That's it for documentation for the RULES file.
  156. These rules can be
  157. changed.  I'll provide more documentation for this if there is a
  158. big enough
  159. demand.
  160.  
  161. SEND ME YOUR GEDCOM
  162.  
  163. Get the full benefits of InstaRel by registering your copy with me.
  164. Your benefits include having us compare your GEDCOM file with the
  165. huge database of GEDCOM files that we have.  You will get a report
  166. showing all those who are working on your lines, and how they are
  167. related to you.   You will also meet new friends and start getting
  168. letters from others when we compare their GEDCOM files with yours.
  169.  
  170. Another benefit you get by registering InstaRel is support.
  171. You also will get the next upgrade of the software.
  172.  
  173. HOW TO REGISTER InstaRel
  174.  
  175. Register InstaRel by sending $30, $15 or whatever you can afford.
  176. I can accept checks, VISA or Mastercard.  This
  177. support from you will allow  me to continue to enhance your program
  178. and write new genealogy utilities.
  179.  
  180. I'll include a file that you can use to register your product, or
  181. you can call my BBS (and leave me a message with your VISA number
  182. and expiration date) at (801)466-5374, or leave a message at (801)
  183. 575-1910 or call my home at (801) 484-6958.  My address:
  184.  
  185. Larry Maddocks, Manager
  186. Knowledge Software Systems, L.C.
  187. 935 Best Ave.
  188. Salt Lake City, Utah 84106
  189.  
  190. FUTURE VERSIONS
  191.  
  192. There are times when nothing seems to be happening in InstaRel.
  193. The program is not hung, but it does need more status messages.
  194.  
  195. It would be nice to change the threshold from the program, save the
  196. configurations, have InstaRel generate letters to your new-found
  197. cousins, to have a better looking match report.
  198.  
  199. NOTE:
  200.  
  201. With this first version, exit the program before running the next
  202. comparison and backup the file (called out.std) which contains the
  203. match report.  The 2nd output report does not get a header on it,
  204. and it overwrites the last output report.
  205.  
  206. FILES
  207.  
  208. RULES               This contains the rules that InstaRel uses to
  209.                     determine matches.  This file can be changed
  210.                     by the user, but there is no documentation or
  211.                     support for doing so.  This file also contains
  212.                     a line for changing the threshold.  See the
  213.                     on-line documentation for details.  To get to
  214.                     the on-line doc's, get into InstaRel and press
  215.                     the F1 key.
  216. SUBMIT              Keeps a record of submitters of GEDCOM files.
  217. INSTAREL EXE        Instant Relatives(tm), the executable program.
  218. HR       GRM        A grammar file that is used by InstaRel to
  219.                     store the database.
  220. HR       SLO        Slow version of HR.GRM
  221. INSTAREL HLP        The on-line help file.
  222. YOURDB   HSH        Created by InstaRel.  Gets deleted when you
  223.                     want to start a new database.
  224. YOURDB   SRT        ditto
  225. THEIRDB  HSH        ditto
  226. THEIRDB  SRT        ditto
  227. YOURDB   STD        ditto
  228. THEIRDB  STD        ditto
  229. OUT      STD        Contains the match report.  You may wish to
  230.                     print this out.  I'll see if I can make a
  231.                     print option in a next version.
  232. ORDER    TXT        Order form
  233. WARRANTY TXT        Our warranty.
  234. FILE_ID  DIZ        Description of this product
  235. README   TXT        This file
  236.